home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-modemmgt-mdmmib-00.txt < prev    next >
Encoding:
Text File  |  1993-10-26  |  33.6 KB  |  1,472 lines
  1. draft                          Modem MIB                October 21, 1993
  2.  
  3.  
  4.                                Modem MIB
  5.                   <draft-ietf-modemmgt-mdmmib-00.txt>
  6.  
  7.                             October 21, 1993
  8.  
  9.  
  10.                Les Brown, Rick Roysten, Steven Waldbusser
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                           Status of this Memo
  17.  
  18. This document is an Internet Draft.  Internet Drafts are working
  19. documents of the Internet Engineering Task Force (IETF), its Areas, and
  20. its Working Groups.  Note that other groups may also distribute working
  21. documents as Internet Drafts.
  22.  
  23. Internet Drafts are valid for a maximum of six months and may be
  24. updated, replaced, or obsoleted by other documents at any time.  It is
  25. inappropriate to use Internet Drafts as reference material or to cite
  26. them other than as a "work in progress".
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Expires April 21, 1994                                          [Page 1]
  55.  
  56.  
  57.  
  58.  
  59.  
  60. draft                          Modem MIB                October 21, 1993
  61.  
  62.  
  63. 1.  Introduction
  64.  
  65. This memo defines an experimental portion of the Management Information
  66. Base (MIB) for use with network management protocols in the Internet
  67. community.  In particular, it describes managed objects used for
  68. managing dial-up modems and similar dial-up devices.  This MIB module
  69. provides a set of objects that are the minimum necessary to provide the
  70. ability to monitor and control those devices, and is consistent with the
  71. SNMP framework and existing SNMP standards.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113. Expires April 21, 1994                                          [Page 2]
  114.  
  115.  
  116.  
  117.  
  118.  
  119. draft                          Modem MIB                October 21, 1993
  120.  
  121.  
  122. 2.  The SNMPv2 Network Management Framework
  123.  
  124. The SNMPv2 Network Management Framework consists of four major
  125. components.  They are:
  126.  
  127. o    RFC 1442 which defines the SMI, the mechanisms used for describing
  128.      and naming objects for the purpose of management.
  129.  
  130. o    RFC 1213 defines MIB-II, the core set of managed objects for the
  131.      Internet suite of protocols.
  132.  
  133. o    RFC 1445 which defines the administrative and other architectural
  134.      aspects of the framework.
  135.  
  136. o    RFC 1448 which defines the protocol used for network access to
  137.      managed objects.
  138.  
  139. The Framework permits new objects to be defined for the purpose of
  140. experimentation and evaluation.
  141.  
  142.  
  143. 2.1.  Object Definitions
  144.  
  145. Managed objects are accessed via a virtual information store, termed the
  146. Management Information Base or MIB.  Objects in the MIB are defined
  147. using the subset of Abstract Syntax Notation One (ASN.1) defined in the
  148. SMI.  In particular, each object object type is named by an OBJECT
  149. IDENTIFIER, an administratively assigned name.  The object type together
  150. with an object instance serves to uniquely identify a specific
  151. instantiation of the object.  For human convenience, we often use a
  152. textual string, termed the descriptor, to refer to the object type.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172. Expires April 21, 1994                                          [Page 3]
  173.  
  174.  
  175.  
  176.  
  177.  
  178. draft                          Modem MIB                October 21, 1993
  179.  
  180.  
  181. 3.  Definitions
  182.  
  183. Modem-MIB DEFINITIONS ::= BEGIN
  184.  
  185.  
  186. IMPORTS
  187.     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  188.     experimental
  189.     FROM SNMPv2-SMI
  190.     DisplayString, TruthValue, TimeInterval FROM SNMPv2-TC
  191.     MODULE-COMPLIANCE, OBJECT-GROUP
  192.     FROM SNMPv2-CONF;
  193.  
  194.  
  195. mdmMIB MODULE-IDENTITY
  196.     LAST-UPDATED "9310120000Z"
  197.     ORGANIZATION "IETF Modem Management Working Group"
  198.     CONTACT-INFO
  199.             "        Steven Waldbusser
  200.          Postal: Carnegie Mellon University
  201.                      4910 Forbes Ave
  202.                   Pittsburgh, PA, 15213
  203.  
  204.                 Tel: 412-268-6628
  205.                 Fax: 412-268-4987
  206.              E-mail: waldbusser@cmu.edu"
  207.     DESCRIPTION
  208.             "The MIB module for management of dial-up modems."
  209.     ::= { experimental 49 }
  210.  
  211. mdmMIBObjects OBJECT IDENTIFIER ::= { mdmMIB 1 }
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231. Expires April 21, 1994                                          [Page 4]
  232.  
  233.  
  234.  
  235.  
  236.  
  237. draft                          Modem MIB                October 21, 1993
  238.  
  239.  
  240. -- conformance information
  241.  
  242. mdmConformance OBJECT IDENTIFIER ::= { mdmMIB 2 }
  243.  
  244. mdmGroups      OBJECT IDENTIFIER ::= { mdmConformance 1 }
  245. mdmCompliances OBJECT IDENTIFIER ::= { mdmConformance 2 }
  246.  
  247.  
  248. -- compliance statements
  249.  
  250. mdmCompliance MODULE-COMPLIANCE
  251.     STATUS  current
  252.     DESCRIPTION
  253.             "The compliance statement for SNMPv2 entities which
  254.             implement the modem MIB."
  255.  
  256.     MODULE  -- this module
  257.         MANDATORY-GROUPS { mdmIDGroup, mdmLineInterfaceGroup,
  258.                 mdmDTEInterfaceGroup, mdmCallControlGroup,
  259.                 mdmCallStateGroup, mdmStatisticsGroup }
  260.  
  261.         GROUP   mdmDataCompressionGroup
  262.         DESCRIPTION
  263.             "The mdmDataCompressionGroup group is mandatory only for
  264.             those modems that implement data compression."
  265.     ::= { mdmCompliances 1 }
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290. Expires April 21, 1994                                          [Page 5]
  291.  
  292.  
  293.  
  294.  
  295.  
  296. draft                          Modem MIB                October 21, 1993
  297.  
  298.  
  299. -- units of conformance
  300.  
  301. mdmIDGroup    OBJECT-GROUP
  302.     OBJECTS { mdmIDModelOID, mdmIDModel, mdmIDCountry,
  303.               mdmIDHardwareSerNum, mdmIDHardwareRev, mdmIDFirmwareRev }
  304.     STATUS  current
  305.     DESCRIPTION
  306.             "A collection of objects that identify the model and
  307.             configuration of a modem."
  308.     ::= { mdmGroups 1 }
  309.  
  310. mdmLineInterfaceGroup    OBJECT-GROUP
  311.     OBJECTS { List, of, objects, to, be, included, when, MIB, is, less, fluid }
  312.     STATUS  current
  313.     DESCRIPTION
  314.             "A collection of objects that describe the configuration and
  315.             state of the modem's line interface."
  316.     ::= { mdmGroups 2 }
  317.  
  318. mdmDTEInterfaceGroup    OBJECT-GROUP
  319.     OBJECTS { List, of, objects, to, be, included, when, MIB, is, less, fluid }
  320.     STATUS  current
  321.     DESCRIPTION
  322.             "A collection of objects that describe the configuration and
  323.             state of the modem's DTE interface."
  324.     ::= { mdmGroups 3 }
  325.  
  326. mdmCallControlGroup    OBJECT-GROUP
  327.     OBJECTS { List, of, objects, to, be, included, when, MIB, is, less, fluid }
  328.     STATUS  current
  329.     DESCRIPTION
  330.             "A collection of objects that describe the configuration of
  331.             call control capabilities on the modem."
  332.     ::= { mdmGroups 4 }
  333.  
  334. mdmCallStateGroup    OBJECT-GROUP
  335.     OBJECTS { List, of, objects, to, be, included, when, MIB, is, less, fluid }
  336.     STATUS  current
  337.     DESCRIPTION
  338.             "A collection of objects that describe the state of calls on
  339.             this modem."
  340.     ::= { mdmGroups 5 }
  341.  
  342. mdmStatisticsGroup  OBJECT-GROUP
  343.     OBJECTS { List, of, objects, to, be, included, when, MIB, is, less, fluid }
  344.  
  345.  
  346.  
  347.  
  348.  
  349. Expires April 21, 1994                                          [Page 6]
  350.  
  351.  
  352.  
  353.  
  354.  
  355. draft                          Modem MIB                October 21, 1993
  356.  
  357.  
  358.     STATUS  current
  359.     DESCRIPTION
  360.             "A collection of objects that describe the state of calls on
  361.             this modem."
  362.     ::= { mdmGroups 6 }
  363.  
  364. mdmSignalConverterGroup  OBJECT-GROUP
  365.     OBJECTS { List, of, objects, to, be, included, when, MIB, is, less, fluid }
  366.     STATUS  current
  367.     DESCRIPTION
  368.             "A collection of objects that describes the signal converter
  369.             on the modem."
  370.     ::= { mdmGroups 7 }
  371.  
  372. mdmID OBJECT IDENTIFIER ::= { mdmMIB 1 }
  373.  
  374. mdmIDModelOID OBJECT-TYPE
  375.     SYNTAX      OBJECT IDENTIFIER
  376.     MAX-ACCESS  read-only
  377.     STATUS      current
  378.     DESCRIPTION
  379.             "This value is intended to identify the manufacturer, model,
  380.             and version of this modem.  This may be used to identify the
  381.             existance of enterprise specific functions and behaviours."
  382.     ::= { mdmID 1 }
  383.  
  384. mdmIDModel OBJECT-TYPE
  385.     SYNTAX      DisplayString
  386.     MAX-ACCESS  read-only
  387.     STATUS      current
  388.     DESCRIPTION
  389.             "A textual description of this device, including the
  390.             device's manufacturer and revision, and optionally, its
  391.             serial number."
  392.     ::= { mdmID 2 }
  393.  
  394. mdmIDCountry OBJECT-TYPE
  395.     SYNTAX      DisplayString
  396.     MAX-ACCESS  read-only
  397.     STATUS      current
  398.     DESCRIPTION
  399.             "This object identifies the country or countries that this
  400.             modem is configured for use in. This field is assigned by
  401.             the manufacturer."
  402.     ::= { mdmID 3 }
  403.  
  404.  
  405.  
  406.  
  407.  
  408. Expires April 21, 1994                                          [Page 7]
  409.  
  410.  
  411.  
  412.  
  413.  
  414. draft                          Modem MIB                October 21, 1993
  415.  
  416.  
  417. mdmIDHardwareSerNum OBJECT-TYPE
  418.     SYNTAX      DisplayString
  419.     MAX-ACCESS  read-only
  420.     STATUS      current
  421.     DESCRIPTION
  422.             "A textual encoding of the modem's hardware serial number as
  423.             assigned by the manufacturer.  A zero length string implies
  424.             that no serial number was assigned."
  425.     ::= { mdmID 4 }
  426.  
  427. mdmIDHardwareRev OBJECT-TYPE
  428.     SYNTAX      DisplayString
  429.     MAX-ACCESS  read-only
  430.     STATUS      current
  431.     DESCRIPTION
  432.             "A textual description of the hardware revision of the
  433.             modem."
  434.     ::= { mdmID 5 }
  435.  
  436. mdmIDFirmwareRev OBJECT-TYPE
  437.     SYNTAX      DisplayString
  438.     MAX-ACCESS  read-only
  439.     STATUS      current
  440.     DESCRIPTION
  441.             "A textual description of the firmware revision of the
  442.             modem."
  443.     ::= { mdmID 6 }
  444.  
  445. -- The modem Line Interface Group
  446.  
  447. mdmLine OBJECT IDENTIFIER ::= { mdmMIB 2 }
  448.  
  449. mdmLineType OBJECT-TYPE
  450.     SYNTAX      INTEGER {
  451.                     other(1),
  452.                     analogSwitched2Wire(2),
  453.                     analogLeased2Wire(3),
  454.                     analogLeased4Wire(4),
  455.                     pcmSwitched4Wire(5),
  456.                     pcmLeased4Wire(6)
  457.                 }
  458.     MAX-ACCESS  read-write
  459.     STATUS      current
  460.     DESCRIPTION
  461.             "Line operating mode of the modem."
  462.  
  463.  
  464.  
  465.  
  466.  
  467. Expires April 21, 1994                                          [Page 8]
  468.  
  469.  
  470.  
  471.  
  472.  
  473. draft                          Modem MIB                October 21, 1993
  474.  
  475.  
  476.     ::= { mdmLine 1 }
  477.  
  478. mdmLineCarrierLossControl OBJECT-TYPE
  479.     SYNTAX      TruthValue
  480.     MAX-ACCESS  read-write
  481.     STATUS      current
  482.     DEFVAL      { on }
  483.     DESCRIPTION
  484.             "If true, the associated mdmLineCarrierLossTime is consulted
  485.             Dto determine the duration of carrier loss to accept without
  486.             hanging up.  If false, the modem will not hang up upon loss
  487.             of carrier."
  488.     ::= { mdmLine 2 }
  489.  
  490. mdmLineCarrierLossTime OBJECT-TYPE
  491.     SYNTAX      INTEGER (1..254)
  492.     MAX-ACCESS  read-write
  493.     STATUS      current
  494.     DESCRIPTION
  495.             "Duration in 10ths of a second the modem waits after loss of
  496.             carrier before hanging up.  This allows the modem to
  497.             distinguish between a momentary lapse in line quality and a
  498.             true disconnect."
  499.     ::= { mdmLine 3 }
  500.  
  501. mdmLineCapabilitiesTable OBJECT-TYPE
  502.     SYNTAX      SEQUENCE OF MdmLineCapabilitiesEntry
  503.     MAX-ACCESS  not-accessible
  504.     STATUS      current
  505.     DESCRIPTION
  506.             "A list of protocol capabilities for this modem."
  507.     ::= { mdmLine 4 }
  508.  
  509.  
  510. mdmLineCapabilitiesEntry OBJECT-TYPE
  511.     SYNTAX      MdmLineCapabilitiesEntry
  512.     MAX-ACCESS  not-accessible
  513.     STATUS      current
  514.     DESCRIPTION
  515.             "A listing of a protocol that this modem is capable of.
  516.             Entries in this table are created only by the agent.  One
  517.             entry exists for each protocol that the modem is capable of,
  518.             regardless of whether that protocol is enabled or not."
  519.     INDEX       { mdmLineCapabilitiesIndex }
  520.     ::= { mdmLineCapabilitiesTable 1 }
  521.  
  522.  
  523.  
  524.  
  525.  
  526. Expires April 21, 1994                                          [Page 9]
  527.  
  528.  
  529.  
  530.  
  531.  
  532. draft                          Modem MIB                October 21, 1993
  533.  
  534.  
  535. MdmLineCapabilitiesEntry ::= SEQUENCE {
  536.     mdmLineCapabilitiesIndex            INTEGER,
  537.     mdmLineCapabilitiesID               OBJECT IDENTIFIER,
  538.     mdmLineCapabilitiesEnableRequested  INTEGER,
  539.     mdmLineCapabilitiesEnableGranted    INTEGER
  540. }
  541.  
  542. mdmLineCapabilitiesIndex OBJECT-TYPE
  543.     SYNTAX      INTEGER
  544.     MAX-ACCESS  read-only
  545.     STATUS      current
  546.     DESCRIPTION
  547.             "A unique index for this capabilities entry."
  548.     ::= { mdmLineCapabilitiesEntry 1 }
  549.  
  550. mdmLineCapabilitiesID OBJECT-TYPE
  551.     SYNTAX      OBJECT IDENTIFIER
  552.     MAX-ACCESS  read-only
  553.     STATUS      current
  554.     DESCRIPTION
  555.             "An identifier for this capability.  Standard protocol
  556.             capabilities will have identifiers registered in this
  557.             document or other companion standards documents.
  558.             Proprietary protocol capabilities will be registered by
  559.             their respective organization.  All capabilities, standard
  560.             or vendor-specific, shall be registered in this table."
  561.     ::= { mdmLineCapabilitiesEntry 2 }
  562.  
  563. mdmLineCapabilities   OBJECT IDENTIFIER ::= { mdmLineCapabilitiesTable 2 }
  564. mdmLineCapabilitiesV22     OBJECT IDENTIFIER ::= { mdmLineCapabilities 1 }
  565. mdmLineCapabilitiesV22bis  OBJECT IDENTIFIER ::= { mdmLineCapabilities 2 }
  566. mdmLineCapabilitiesV32     OBJECT IDENTIFIER ::= { mdmLineCapabilities 3 }
  567. mdmLineCapabilitiesV32bis  OBJECT IDENTIFIER ::= { mdmLineCapabilities 4 }
  568. mdmLineCapabilitiesV34     OBJECT IDENTIFIER ::= { mdmLineCapabilities 5 }
  569. mdmLineCapabilitiesV42     OBJECT IDENTIFIER ::= { mdmLineCapabilities 6 }
  570. mdmLineCapabilitiesV42bis  OBJECT IDENTIFIER ::= { mdmLineCapabilities 7 }
  571. mdmLineCapabilitiesMNP4    OBJECT IDENTIFIER ::= { mdmLineCapabilities 8 }
  572. mdmLineCapabilitiesMNP5    OBJECT IDENTIFIER ::= { mdmLineCapabilities 9 }
  573. mdmLineCapabilitiesV29     OBJECT IDENTIFIER ::= { mdmLineCapabilities 10 }
  574. mdmLineCapabilitiesV33     OBJECT IDENTIFIER ::= { mdmLineCapabilities 11 }
  575. mdmLineCapabilitiesBell208 OBJECT IDENTIFIER ::= { mdmLineCapabilities 12 }
  576.  
  577. mdmLineCapabilitiesEnableRequested OBJECT-TYPE
  578.     SYNTAX      INTEGER {
  579.                     disabled(1),
  580.  
  581.  
  582.  
  583.  
  584.  
  585. Expires April 21, 1994                                         [Page 10]
  586.  
  587.  
  588.  
  589.  
  590.  
  591. draft                          Modem MIB                October 21, 1993
  592.  
  593.  
  594.                     optional(2),
  595.                     preferred(3)
  596.                 }
  597.     MAX-ACCESS  read-write
  598.     STATUS      current
  599.     DESCRIPTION
  600.             "The requested configuration of this capability.  If this
  601.             value is 'disabled(1)', this is a request to disable this
  602.             protocol.  If this value is 'preferred(3)', this is a
  603.             request to enable this protocol, and to prefer it in any
  604.             negotiation over other appropriate protocols that have a
  605.             value of 'optional(2)'."
  606.     DEFVAL      { preferred }
  607.     ::= { mdmLineCapabilitiesEntry 3 }
  608.  
  609. mdmLineCapabilitiesEnableGranted OBJECT-TYPE
  610.     SYNTAX      INTEGER {
  611.                     disabled(1),
  612.                     optional(2),
  613.                     preferred(3)
  614.                 }
  615.     MAX-ACCESS  read-only
  616.     STATUS      current
  617.     DESCRIPTION
  618.             "The actual configuration of this capability.  The agent
  619.             shall attempt to set this as close as possible to the
  620.             associated mdmLineCapabilitiesEnableRequested value.  The
  621.             agent shall make this determination in an implementation-
  622.             specific manner that may take into account the configuration
  623.             of other capabilities or other considerations.  The modem
  624.             will choose in an implementation-specific manner between
  625.             multiple mutually-exclusive capabilities that each have the
  626.             same (non-disabled) value.  However, the modem must prefer
  627.             all capabilities with a value of 'preferred(3)' over all
  628.             capabilities with a value of 'optional(2)'."
  629.     ::= { mdmLineCapabilitiesEntry 4 }
  630.  
  631. --[** Need to add metric for throughput]
  632.  
  633. -- DTE Interface Group
  634.  
  635. mdmDTEInterface OBJECT IDENTIFIER ::= { mdmMIB 3 }
  636.  
  637. mdmDTEActionOnDTROnToOff OBJECT-TYPE
  638.     SYNTAX      INTEGER {
  639.  
  640.  
  641.  
  642.  
  643.  
  644. Expires April 21, 1994                                         [Page 11]
  645.  
  646.  
  647.  
  648.  
  649.  
  650. draft                          Modem MIB                October 21, 1993
  651.  
  652.  
  653.                     ignore(1),
  654.                     escapetocommandmode(2),
  655.                     disconnetcall(3),
  656.                     resetmodem(4)
  657.                 }
  658.     MAX-ACCESS  read-write
  659.     STATUS      current
  660.     DESCRIPTION
  661.             "When true(1), the modem will restart when the DTR control
  662.             signal drops"
  663.     DEFVAL { true }
  664.     ::= { mdmDTEInterface 1 }
  665.  
  666. mdmDTEActionOnDTROffToOn OBJECT-TYPE
  667.     SYNTAX      INTEGER {
  668.                     ignore(1),
  669.                     enabledial(2),
  670.                     autoAnswerEnable(3),
  671.                     establishConnection(4)
  672.                 }
  673.     MAX-ACCESS  read-write
  674.     STATUS      current
  675.     DESCRIPTION
  676.             "When true(1), the modem will restart when the DTR control
  677.             signal turns on"
  678.     DEFVAL { true }
  679.     ::= { mdmDTEInterface 2 }
  680.  
  681. mdmDTESyncTimingSource OBJECT-TYPE
  682.     SYNTAX      INTEGER {
  683.                     internal(1),
  684.                     external(2),
  685.                     loopback(3),
  686.                     network(4)
  687.                 }
  688.     MAX-ACCESS  read-write
  689.     STATUS      current
  690.     DESCRIPTION
  691.             "The clock source for synchronous transmissions."
  692.     DEFVAL { internal }
  693.     ::= { mdmDTEInterface 3 }
  694.  
  695. mdmDTESyncAsyncMode OBJECT-TYPE
  696.     SYNTAX      INTEGER {
  697.                     async(1),
  698.  
  699.  
  700.  
  701.  
  702.  
  703. Expires April 21, 1994                                         [Page 12]
  704.  
  705.  
  706.  
  707.  
  708.  
  709. draft                          Modem MIB                October 21, 1993
  710.  
  711.  
  712.                     sync(2),
  713.                     syncAfterDial(3)
  714.                 }
  715.     MAX-ACCESS  read-write
  716.     STATUS      current
  717.     DESCRIPTION
  718.             "Operational mode of the modem."
  719.     ::= { mdmDTEInterface 4 }
  720.  
  721. mdmCallControl OBJECT IDENTIFIER ::= { mdmMIB 4 }
  722.  
  723. mdmInactivityTimeout OBJECT-TYPE
  724.     SYNTAX      TimeInterval
  725.     MAX-ACCESS  read-write
  726.     STATUS      current
  727.     DESCRIPTION
  728.             "The amount of idle time that the modem will wait before
  729.             disconnecting a connection.  If the value is 0, no idle
  730.             disconnect will occur."
  731.     DEFVAL { 0 }
  732.     ::= { mdmCallControl 1 }
  733.  
  734. mdmAutoDial OBJECT-TYPE
  735.     SYNTAX      INTEGER {
  736.                     disable(1),
  737.                     dialOnDTRHi(2),
  738.                     dialAfterInitialization(3),
  739.                     dialAfterInitializationOrDTRHi(4)
  740.                 }
  741.     MAX-ACCESS  read-write
  742.     STATUS      current
  743.     DESCRIPTION
  744.             "Configures when the modem will automatically dial the
  745.             default phone number (???).  Note that initialization occurs
  746.             after power on or reset."
  747.     DEFVAL { disable }
  748.     ::= { mdmCallControl 2 }
  749.  
  750. mdmResultCodeEnable OBJECT-TYPE
  751.     SYNTAX      INTEGER {
  752.                     enable(1),
  753.                     disable(2)
  754.                 }
  755.     MAX-ACCESS  read-write
  756.     STATUS      current
  757.  
  758.  
  759.  
  760.  
  761.  
  762. Expires April 21, 1994                                         [Page 13]
  763.  
  764.  
  765.  
  766.  
  767.  
  768. draft                          Modem MIB                October 21, 1993
  769.  
  770.  
  771.     DESCRIPTION
  772.             "Configures whether the modem will display result codes to
  773.             the DTE."
  774.     DEFVAL { enable }
  775.     ::= { mdmCallControl 3 }
  776.  
  777. mdmEscapeAction OBJECT-TYPE
  778.     SYNTAX      INTEGER {
  779.                     ignoreEscape(1),
  780.                     hangUp(2),
  781.                     enterCommandMode(3)
  782.                 }
  783.     MAX-ACCESS  read-write
  784.     STATUS      current
  785.     DESCRIPTION
  786.             "The modem's action upon successfully recognizing an escape
  787.             code."
  788.     DEFVAL { ignoreEscape }
  789.     ::= { mdmCallControl 4 }
  790.  
  791. mdmAutoAnswer OBJECT-TYPE
  792.     SYNTAX      TruthValue
  793.     MAX-ACCESS  read-write
  794.     STATUS      current
  795.     DESCRIPTION
  796.             "Determines whether or not this modem will automatically go
  797.             offhook and answer the call when it detects a ring signal."
  798.     DEFVAL { enable }
  799.     ::= { mdmCallControl 5 }
  800.  
  801. mdmStoredDialStringTable OBJECT-TYPE
  802.     SYNTAX      SEQUENCE OF MdmStoredDialStringEntry
  803.     MAX-ACCESS  not-accessible
  804.     STATUS      current
  805.     DESCRIPTION
  806.             "The table of stored dial strings."
  807.     ::= { mdmCallControl 6 }
  808.  
  809. mdmStoredDialStringEntry OBJECT-TYPE
  810.     SYNTAX      MdmStoredDialStringEntry
  811.     MAX-ACCESS  not-accessible
  812.     STATUS      current
  813.     DESCRIPTION
  814.             "A stored dial string."
  815.     INDEX  { mdmStoredDialStringIndex }
  816.  
  817.  
  818.  
  819.  
  820.  
  821. Expires April 21, 1994                                         [Page 14]
  822.  
  823.  
  824.  
  825.  
  826.  
  827. draft                          Modem MIB                October 21, 1993
  828.  
  829.  
  830.     ::= { mdmStoredDialStringTable 1 }
  831.  
  832. MdmStoredDialStringEntry ::= SEQUENCE {
  833.     mdmStoredDialStringIndex     INTEGER,
  834.     mdmStoredDialString          DisplayString
  835. }
  836.  
  837. mdmStoredDialStringIndex OBJECT-TYPE
  838.     SYNTAX      INTEGER (0..65535)
  839.     MAX-ACCESS  not-accessible
  840.     STATUS      current
  841.     DESCRIPTION
  842.             "The unique index of a particular dial string."
  843.     ::= { mdmStoredDialStringEntry 1 }
  844.  
  845. mdmStoredDialString OBJECT-TYPE
  846.     SYNTAX      DisplayString
  847.     MAX-ACCESS  not-accessible
  848.     STATUS      current
  849.     DESCRIPTION
  850.             "A dial string stored in the modem."
  851.     ::= { mdmStoredDialStringEntry 2 }
  852.  
  853.  
  854. -- The Call State group
  855.  
  856. mdmCs OBJECT IDENTIFIER ::= { mdmMIB 5 }
  857.  
  858. mdmCsCallDuration OBJECT-TYPE
  859.     SYNTAX      INTEGER
  860.     MAX-ACCESS  read-only
  861.     STATUS      current
  862.     DESCRIPTION
  863.             "Present or last completed connection time in seconds. If
  864.             there have been no previous connections this value should be
  865.             -1."
  866.     ::= { mdmCs 1 }
  867.  
  868. mdmCsConnectFailReason OBJECT-TYPE --  [** EDs to reduce to resonable number]
  869.     SYNTAX      INTEGER {
  870.                     dtrDrop(1),
  871.                     escapeSequence(2),
  872.                     athCommand(3),
  873.                     carrierLoss(4),
  874.                     inactivityTimout(5),
  875.  
  876.  
  877.  
  878.  
  879.  
  880. Expires April 21, 1994                                         [Page 15]
  881.  
  882.  
  883.  
  884.  
  885.  
  886. draft                          Modem MIB                October 21, 1993
  887.  
  888.  
  889.                     mnpIncompatible(6),
  890.                     undefined(7),
  891.                     remotePassword(8),
  892.                     linkPassword(9),   -- Rename link EC
  893.                     retransmitLimit(10),
  894.                     linkDisconnectMsgReceived(11),
  895.                     loopLoss(12),
  896.                     invalidSpeed(13),
  897.                     unableToRetrain(14),
  898.                     managementCommand(15),
  899.                     noDialTone(16),
  900.                     keyAbort(17),
  901.                     lineBusy(18),
  902.                     noAnswer(19),
  903.                     voice(20),
  904.                     noAnswerTone(21),
  905.                     noCarrier(22),
  906.                     undetermined(23),
  907.                     v42SabmeTimeout(24),
  908.                     v42BreakTimeout(25),
  909.                     v42DisconnectCmd(26),
  910.                     v42IdExchangeFail(27),
  911.                     v42BadSetup(28),
  912.                     v42InvalidCodeWord(29),
  913.                     v42StringToLong(30),
  914.                     v42InvalidCommand(31),
  915.                     none(32),
  916.                     v32Cleardown(33),
  917.                 }
  918.     MAX-ACCESS  read-only
  919.     STATUS      current
  920.     DESCRIPTION
  921.             "Defines the reason that the last call attempt failure
  922.             occured."
  923.     ::= { mdmCs 2 }
  924.  
  925. mdmCsCurrentLineRate OBJECT-TYPE
  926.     SYNTAX      INTEGER
  927.     MAX-ACCESS  read-only
  928.     STATUS      current
  929.     DESCRIPTION
  930.             "The current link rate of a connection, or the last link
  931.             rate of the last connection in bits per second."
  932.     ::= { mdmCs 3 }
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939. Expires April 21, 1994                                         [Page 16]
  940.  
  941.  
  942.  
  943.  
  944.  
  945. draft                          Modem MIB                October 21, 1993
  946.  
  947.  
  948. mdmCsModulationSchemeUsed OBJECT-TYPE
  949.     SYNTAX      OBJECT IDENTIFIER
  950.     MAX-ACCESS  read-only
  951.     STATUS      current
  952.     DESCRIPTION
  953.             "The current modulation scheme.  This shall be one of the
  954.             values for modulation protocols registered in the
  955.             capabilities table."
  956.     ::= { mdmCs 4 }
  957.  
  958. mdmCsErrorControlUsed OBJECT-TYPE
  959.     SYNTAX      OBJECT IDENTIFIER
  960.     MAX-ACCESS  read-only
  961.     STATUS      current
  962.     DESCRIPTION
  963.             "Specifies the error control settings in the current call.
  964.             This shall be one of the values for error control protocols
  965.             registered in the capabilities table.  If no error control
  966.             protocol is in use, this shall have the value '{0 0}'."
  967.     ::= { mdmCs 5 }
  968.  
  969. mdmCsCompressionTypeUsed OBJECT-TYPE
  970.     SYNTAX      OBJECT IDENTIFIER
  971.     MAX-ACCESS  read-only
  972.     STATUS      current
  973.     DESCRIPTION
  974.             "Specifies the data compression used in the current call.
  975.             This shall be one of the values for compression protocols
  976.             registered in the capabilities table.  If no compression
  977.             protocol is in use, this shall have the value '{0 0}'."
  978.     ::= { mdmCs 6 }
  979.  
  980. -- Modem Statistics Group
  981.  
  982. mdmStats OBJECT IDENTIFIER ::= { mdmMIB 6 }
  983.  
  984. mdmStatsIncomingConnectionRequests OBJECT-TYPE
  985.     SYNTAX      Counter
  986.     MAX-ACCESS  read-only
  987.     STATUS      current
  988.     DESCRIPTION
  989.             "The number of incoming connection requests."
  990.     ::= { mdmStats 1 }
  991.  
  992. mdmStatsIncomingConnectionFailures OBJECT-TYPE
  993.  
  994.  
  995.  
  996.  
  997.  
  998. Expires April 21, 1994                                         [Page 17]
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004. draft                          Modem MIB                October 21, 1993
  1005.  
  1006.  
  1007.     SYNTAX      Counter
  1008.     MAX-ACCESS  read-only
  1009.     STATUS      current
  1010.     DESCRIPTION
  1011.             "The number of incoming connection requests that failed to
  1012.             establish a connection."
  1013.     ::= { mdmStats 2 }
  1014.  
  1015. mdmStatsIncomingAbnormalTerminations OBJECT-TYPE
  1016.     SYNTAX      Counter
  1017.     MAX-ACCESS  read-only
  1018.     STATUS      current
  1019.     DESCRIPTION
  1020.             "The number of abnormal terminations of established incoming
  1021.             connections."
  1022.     ::= { mdmStats 3 }
  1023.  
  1024. mdmStatsOutgoingConnectionRequests OBJECT-TYPE
  1025.     SYNTAX      Counter
  1026.     MAX-ACCESS  read-only
  1027.     STATUS      current
  1028.     DESCRIPTION
  1029.             "The number of outgoing connection requests."
  1030.     ::= { mdmStats 4 }
  1031.  
  1032. mdmStatsOutgoingConnectionFailures OBJECT-TYPE
  1033.     SYNTAX      Counter
  1034.     MAX-ACCESS  read-only
  1035.     STATUS      current
  1036.     DESCRIPTION
  1037.             "The number of outgoing connection requests that failed to
  1038.             establish a connection."
  1039.     ::= { mdmStats 5 }
  1040.  
  1041. mdmStatsOutgoingAbnormalTerminations OBJECT-TYPE
  1042.     SYNTAX      Counter
  1043.     MAX-ACCESS  read-only
  1044.     STATUS      current
  1045.     DESCRIPTION
  1046.             "The number of abnormal terminations of established outgoing
  1047.             connections."
  1048.     ::= { mdmStats 6 }
  1049.  
  1050. mdmStatsConnectionTimeouts OBJECT-TYPE
  1051.     SYNTAX      Counter
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057. Expires April 21, 1994                                         [Page 18]
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063. draft                          Modem MIB                October 21, 1993
  1064.  
  1065.  
  1066.     MAX-ACCESS  read-only
  1067.     STATUS      current
  1068.     DESCRIPTION
  1069.             "The number of connection attempts (incoming and outgoing)
  1070.             that failed to sync up and were timed out."
  1071.     ::= { mdmStats 7 }
  1072.  
  1073.  
  1074. mdmStatsCarrierLossDisconnects OBJECT-TYPE
  1075.     SYNTAX      Counter
  1076.     MAX-ACCESS  read-only
  1077.     STATUS      current
  1078.     DESCRIPTION
  1079.             "The number of connections (incoming and outgoing) that were
  1080.             disconnected due to carrier loss."
  1081.     ::= { mdmStats 8 }
  1082.  
  1083.  
  1084. mdmStatsWatchdogTimeouts OBJECT-TYPE
  1085.     SYNTAX      Counter
  1086.     MAX-ACCESS  read-only
  1087.     STATUS      current
  1088.     DESCRIPTION
  1089.             "The number of watchdog timeouts detected for this modem."
  1090.     ::= { mdmStats 9 }
  1091.  
  1092. mdmStatsInactivityTimeouts OBJECT-TYPE
  1093.     SYNTAX      Counter
  1094.     MAX-ACCESS  read-only
  1095.     STATUS      current
  1096.     DESCRIPTION
  1097.             "The number of times this modem had an idle time exceeding
  1098.             the inactivity timeout value."
  1099.     ::= { mdmStats 10 }
  1100.  
  1101. mdmStatsDTERingNoAnswers OBJECT-TYPE
  1102.     SYNTAX      Counter
  1103.     MAX-ACCESS  read-only
  1104.     STATUS      current
  1105.     DESCRIPTION
  1106.             "The number of events in which the modem has detected
  1107.             ringing, and enough rings were received to answer the call,
  1108.             but the DTE did not provide DTR in time to answer the call."
  1109.     ::= { mdmStats 11 }
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116. Expires April 21, 1994                                         [Page 19]
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. draft                          Modem MIB                October 21, 1993
  1123.  
  1124.  
  1125. mdmStatsSyncLostEvents OBJECT-TYPE
  1126.     SYNTAX      Counter
  1127.     MAX-ACCESS  read-only
  1128.     STATUS      current
  1129.     DESCRIPTION
  1130.             "The number of times carrier sync was lost on this modem."
  1131.     ::= { mdmStats 12 }
  1132.  
  1133. mdmStatsRetrains OBJECT-TYPE
  1134.     SYNTAX      Counter
  1135.     MAX-ACCESS  read-only
  1136.     STATUS      current
  1137.     DESCRIPTION
  1138.             "The number of retrains experienced on connections on this
  1139.             line."
  1140.     ::= { mdmStats 13 }
  1141.  
  1142.  
  1143. -- Utilization counters
  1144.  
  1145. mdmStats2400OrLessConnections OBJECT-TYPE
  1146.     SYNTAX      Counter32
  1147.     MAX-ACCESS  read-only
  1148.     STATUS      current
  1149.     DESCRIPTION
  1150.             "The number of connections initially established at a
  1151.             modulation speed of 2400 bits per second or less."
  1152.     ::= { mdmStats 14 }
  1153.  
  1154.  
  1155. mdmStats2400To14400Connections OBJECT-TYPE
  1156.     SYNTAX      Counter32
  1157.     MAX-ACCESS  read-only
  1158.     STATUS      current
  1159.     DESCRIPTION
  1160.             "The number of connections initially established at a
  1161.             modulation speed of greater than 2400 bits per second and
  1162.             less than 14400 bits per second."
  1163.     ::= { mdmStats 15 }
  1164.  
  1165. mdmStatsGreaterThan14400Connections OBJECT-TYPE
  1166.     SYNTAX      Counter32
  1167.     MAX-ACCESS  read-only
  1168.     STATUS      current
  1169.     DESCRIPTION
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175. Expires April 21, 1994                                         [Page 20]
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181. draft                          Modem MIB                October 21, 1993
  1182.  
  1183.  
  1184.             "The number of connections initially established at a
  1185.             modulation speed of greater than 14400 bits per second."
  1186.     ::= { mdmStats 16 }
  1187.  
  1188. mdmStatsErrorControlledConnections OBJECT-TYPE
  1189.     SYNTAX      Counter32
  1190.     MAX-ACCESS  read-only
  1191.     STATUS      current
  1192.     DESCRIPTION
  1193.             "The number of established connections using an error
  1194.             control protocol."
  1195.     ::= { mdmStats 17 }
  1196.  
  1197. mdmStatsCompressedConnections OBJECT-TYPE
  1198.     SYNTAX      Counter32
  1199.     MAX-ACCESS  read-only
  1200.     STATUS      current
  1201.     DESCRIPTION
  1202.             "The number of established connections using a compression
  1203.             protocol."
  1204.     ::= { mdmStats 18 }
  1205.  
  1206. mdmStatsSentOctets OBJECT-TYPE
  1207.     SYNTAX      Counter
  1208.     MAX-ACCESS  read-only
  1209.     STATUS      current
  1210.     DESCRIPTION
  1211.             "The number of octets presented to the modem by the DTE."
  1212.     ::= { mdmStats 19 }
  1213.  
  1214. mdmStatsReceivedOctets OBJECT-TYPE
  1215.     SYNTAX      Counter
  1216.     MAX-ACCESS  read-only
  1217.     STATUS      current
  1218.     DESCRIPTION
  1219.             "The number of octets presented to the DTE by the modem."
  1220.     ::= { mdmStats 20 }
  1221.  
  1222. mdmStatsSentDataFrames OBJECT-TYPE
  1223.     SYNTAX      Counter
  1224.     MAX-ACCESS  read-only
  1225.     STATUS      current
  1226.     DESCRIPTION
  1227.             "The number of data frames sent (DTE or line?)."
  1228.     ::= { mdmStats 21 }
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234. Expires April 21, 1994                                         [Page 21]
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240. draft                          Modem MIB                October 21, 1993
  1241.  
  1242.  
  1243. mdmStatsReceivedDataFrames OBJECT-TYPE
  1244.     SYNTAX      Counter
  1245.     MAX-ACCESS  read-only
  1246.     STATUS      current
  1247.     DESCRIPTION
  1248.             "The number of data frames received (DTE or line?)."
  1249.     ::= { mdmStats 22 }
  1250.  
  1251. mdmStatsResentFrames OBJECT-TYPE
  1252.     SYNTAX      Counter
  1253.     MAX-ACCESS  read-only
  1254.     STATUS      current
  1255.     DESCRIPTION
  1256.             "The number of times this modem retransmits frames."
  1257.     ::= { mdmStats 23 }
  1258.  
  1259. mdmStatsErrorFrames OBJECT-TYPE
  1260.     SYNTAX      Counter
  1261.     MAX-ACCESS  read-only
  1262.     STATUS      current
  1263.     DESCRIPTION
  1264.             "The number of block errors received on the link."
  1265.     ::= { mdmStats 24 }
  1266.  
  1267. -- Signal Converter Group:
  1268.  
  1269. pmdmSignalConverter OBJECT IDENTIFIER ::= { mdmMIB 7 }
  1270.  
  1271. mdmSignalLowSpeedNegotiation OBJECT-TYPE
  1272.     SYNTAX      INTEGER {
  1273.                     bell(1),
  1274.                     ccitt(2)
  1275.                 }
  1276.     MAX-ACCESS  read-write
  1277.     STATUS      current
  1278.     DESCRIPTION
  1279.             "This attribute determines which low-speed modulation mode
  1280.             is used in the event that a higher modulation mode cannot be
  1281.             made when the modem is set to one of the 'auto' modulation
  1282.             modes."
  1283.     DEFVAL      { bell }
  1284.     ::= { mdmSignalConverter 1 }
  1285.  
  1286. mdmSignalMinDCERate OBJECT-TYPE
  1287.     SYNTAX      INTEGER (300..32000)
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293. Expires April 21, 1994                                         [Page 22]
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299. draft                          Modem MIB                October 21, 1993
  1300.  
  1301.  
  1302.     UNITS       "bits per second"
  1303.     MAX-ACCESS  read-write
  1304.     STATUS      current
  1305.     DESCRIPTION
  1306.             "This attribute specifies the minimum DCE rate at which the
  1307.             modems are configured to communicate."
  1308.     ::= { mdmSignalConverter 2 }
  1309.  
  1310. mdmSignalMaxDCERate OBJECT-TYPE
  1311.     SYNTAX      INTEGER (300..32000)
  1312.     UNITS       "bits per second"
  1313.     MAX-ACCESS  read-write
  1314.     STATUS      current
  1315.     DESCRIPTION
  1316.             "This attribute specifies the maximum DCE rate at which the
  1317.             modems are configured to communicate. DCE rate = Integer
  1318.             value times 100 bit/s."
  1319.     ::= { mdmSignalConverter 3 }
  1320.  
  1321.  
  1322. END
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352. Expires April 21, 1994                                         [Page 23]
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358. draft                          Modem MIB                October 21, 1993
  1359.  
  1360.  
  1361. 4.  Acknowledgements
  1362.  
  1363. This document was produced by the Modem Management Working group.
  1364.  
  1365. In addition, the authors gratefully acknowledge the comments of Tom
  1366. Holodnik and Mark Lewis.
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411. Expires April 21, 1994                                         [Page 24]
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417. draft                          Modem MIB                October 21, 1993
  1418.  
  1419.  
  1420. Table of Contents
  1421.  
  1422.  
  1423. 1 Introduction ....................................................    2
  1424. 2 The SNMPv2 Network Management Framework .........................    3
  1425. 2.1 Object Definitions ............................................    3
  1426. 3 Definitions .....................................................    4
  1427. 4 Acknowledgements ................................................   24
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470. Expires April 21, 1994                                         [Page 25]
  1471.  
  1472.